home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tag_bbs / tagtool2.zip / TAGTOOLS.DOC < prev   
Text File  |  1992-09-18  |  14KB  |  351 lines
  1. ============================================================================
  2.                                 TAGTOOLS
  3.                  TAG tools for SilverXpress Version 300H1
  4.                            HMS Style Message Bases
  5.  
  6.              (TAG Copyright Robert Numerick, and Victor Capton)
  7.               (SilverXpress(tm) CopyRight Santronics Software)
  8.                  (QuickBBS(tm) Copyright Pegasus Software)
  9.  
  10.   Special Thanks to The TAG team (Victor Capton, Paul Williams and Randy
  11.   Goebel) For making the need structures readily available and to Hector
  12.   Santos (author of SilverXpress) for passing on the information I need
  13.   to make TAG integrate more readily with his Excellent SilverXpress
  14.   mail Door.
  15. ============================================================================
  16.  
  17. - Included files
  18.  
  19.   TAG2XPR.EXE     - Creates the necessary QuickBBS system files that
  20.                     Xpress 300H1 expects to find during setup.
  21.  
  22.                       QUICKCFG.DAT
  23.                       MSGCFG  .DAT
  24.                       FILESCFG.DAT
  25.                       LIMITS  .CTL
  26.  
  27.   TAG2EI.EXE      - Creates the drop files XPress 300H1 expects to find
  28.                     when the door executes.
  29.  
  30.                       EXITINFO.BBS
  31.                       ALIAS   .BBS
  32.  
  33.   PREINST.BAT   - Replacement for the PREINST.BAT file that is included
  34.                   with the Xpress 300H1 door package.
  35.  
  36.  
  37. - Obligatory Denial of responsibility
  38.  
  39.   The author if the enclosed utility programs assumes no liability for
  40.   any adverse consequences caused by executing the enclosed files. If
  41.   you don't want to accept the responsibility then do not use the
  42.   programs. Adverse consequences include but are not limited to:
  43.  
  44.         o Loss of data
  45.         o Breach of security
  46.         o Pregnancy
  47.         o Body oder
  48.         o Instigating World WAR
  49.  
  50.  
  51. - Purpose
  52.  
  53.   The purpose of these utilities to to make integration of the popular,
  54.   powerful, and convenient offline mail door, SilverXpress, easier to
  55.   install and more seamlessly integrated to the TAG BBS systems using
  56.   version 2.6 or higher. If you are running TAG and using the Hudson
  57.   (referenced in these docs as HMS) message base system then these
  58.   programs allow you to port your system and security setups to a format
  59.   understood by the Xpress mail door.
  60.  
  61.   As always these utilities are freely available and can be distributed
  62.   as long as they are not modified in any matter. Even though they have
  63.   been released as freeware the copyrights and ownership remain with
  64.   Rick Cooper and Simple Minds Software.
  65.  
  66.  
  67. - Using the TAGTOOLS
  68.  
  69.   I. Installation of the Xpress 300H1 door
  70.  
  71.         The first step in setting up the door with TAG is to create the
  72.         main Xpress door directory.. For the sake of these docs it will
  73.         be assumed that the following directories exist (your own names
  74.         will probably be different).
  75.  
  76.                 C:\BBS          - Directory where STATUS.DAT resides
  77.                 C:\HUDSON       - Path to your Hudson message base directory
  78.                 C:\XPRESS       - Path where the Xpress mail door EXE resides
  79.  
  80.         If you run two bases (one local one echo) or more
  81.  
  82.                 C:\XPRESS\TYPE1 - Echo area data files
  83.                 C:\XPRESS\TYPE2 - Local area Data files
  84.  
  85.         after creating the XPRESS directory unarchive the Xpress archive
  86.         file (SX300H1.ZIP is the original archive) into this newly
  87.         created directory. Now unarchive the XPTOOLS.ZIP file into the
  88.         new Xpress directory as well.. they MUST be unarchived in this
  89.         order as It's critical that you over-write the PREINSTAL.BAT
  90.         file that comes with the Xpress archive.
  91.  
  92.        -= DO not unarchive the nested ZIP files you will find in the
  93.         Xpress archive.. Xpress will handle this and the creation of the
  94.         support file directories it's self. =-
  95.  
  96.         Now type INSTALL.. Xpress will do some maintenance and look for
  97.         old version file that it needs to remove. Next you will be
  98.         prompted for the directory name where your STATUS.DAT file
  99.         resides... And after that a path to your hudson message base.
  100.  
  101.         For those of you wondering why I don't take it directly from TAG
  102.         it's simple.. You may have more than one and Xpress doesn't
  103.         support more than one.. nor does anyone else at this time except
  104.         for TAG (as you have probably already found out.).. So for now
  105.         enter "A" path to (one of) your HMS base directory(s)
  106.  
  107.         You will, at this time, see the TAG2XPR utility progress as it
  108.         created the QBBS data files Xpress will need in a few moments.
  109.         This will happen quite fast. Once complete you will return to
  110.         the Xpress installation program.. When you come to the
  111.         installation paths section MAKE SURE and change the default
  112.         directory for Xpress to install TO .. it needs to be the same as
  113.         the directory above it.
  114.  
  115.         Xpress will now unpack and position all of the related files and
  116.         screens.. it takes a bit of time.. and then will ask you if your
  117.         wish to continue the quick installation.. of course you should
  118.         answer YES. (if something should go wrong rerun the complete
  119.         installation process please)
  120.  
  121.         Answer the questions you will be asked and when you are prompted
  122.         for the location of QUICKCFG.DAT type in the name of the Xpress
  123.         directory (the current directory you are in)
  124.  
  125.         You are now basically Done! only a bit of specific information
  126.         will have to be entered.
  127.  
  128.  
  129.  
  130. ============================================================================
  131.                         -=[ Important NOTE ]=-
  132.  
  133.         At any field within XPADM press F1 for context sensitive help if
  134.         you don't know for sure what is meant.
  135.  
  136. ============================================================================
  137.  
  138.  II. Final setup
  139.  
  140.         You should now type XPADM at the dos prompt and set the areas
  141.         listed below to your own preferences.
  142.  
  143.                 Register        - If you are registered enter your
  144.                                   registration code now
  145.  
  146.                 Net/Echo Mail   - Set the security options the way you
  147.                                   wish them.. I defaulted all of them to
  148.                                   10 so make sure these are set. Also
  149.                                   specifically the ^AINTL flag as to how
  150.                                   your mailer expects it, your
  151.                                   preference to the DUMP and unknown
  152.                                   netmail costs options.
  153.  
  154.                 BBS Information - If you have a Co-Sysop you may want to
  155.                                   enter their name in the assistant
  156.                                   Sysop name field.. The rest should be
  157.                                   correct.
  158.  
  159.                 Node Specifics  - Set any of these options they way they
  160.                                   need to be depending upon how you
  161.                                   plan to use Xpress.
  162.  
  163.                 Transfer Prots  - Modify as needed.. Xpress Does allow
  164.                                   for Bi-Directional protocols BTW.
  165.                                   If you run a lock comport (Xpress will
  166.                                   all ready have the information)
  167.                                   modify the protocols to accommodate
  168.                                   this by adding /LB %lb to the default
  169.                                   protocols..
  170.  
  171.                 Archive Options - Xpress's defaults included ARJ, ARC, LZH,
  172.                                   PAK, ZOO.. but if you need something
  173.                                   else included it here (make sure you
  174.                                   comment out the archive types you do
  175.                                   not support)
  176.  
  177.                 Bulletins       - Up to you.. Remember you can use the
  178.                                   instant display .BSV files created by
  179.                                   THEDRAW.
  180.  
  181.                 FIle Scan       - All of your file areas will be
  182.                                   selected for scanning and your
  183.                                   security (S/L AR flags) will be
  184.                                   respected BUT you may deselect and
  185.                                   areas you don't want Xpress to scan.
  186.  
  187.  
  188.  
  189. -=NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE=-
  190.  
  191.                                   Xpress will be looking for a current
  192.                                   FILES.BBS file in the directory to be
  193.                                   scanned so make sure you use one of
  194.                                   the many utilities out these designed to
  195.                                   create a QBBS format FILES.BBS form
  196.                                   the TAG .DIR file before putting
  197.                                   Xpress online.
  198.  
  199.                 LAN information - Do what you need.. the defaults are
  200.                                   for no LAN
  201.  
  202.                 Xpress Options  - Set these to your own preferences..
  203.                                   they set Xpress specific parameters
  204.                                   and preferences.
  205.  
  206.                 Local Options   - Again it's your system and preferences
  207.  
  208.  
  209.  
  210.   all this only takes a couple of minuets and and is really quite
  211.   painless.
  212.  
  213.  
  214.  
  215. III. Later modifications to your setup
  216.  
  217.         If you modify your setup at a later date simply run the
  218.         TAG2XPR.EXE program again and then run XPADM -U.. all the
  219.         information (system, message, file, and security) will be
  220.         updated.
  221.  
  222.   V. Running the door
  223.  
  224.         Running the door is simple. Create a menu command with:
  225.  
  226.           PKEY  : <
  227.           PDATA : @ XPRESS.BAT
  228.  
  229.           or
  230.           PKEY  : <
  231.           PDATA : @ XPRESS#.BAT   : For Echo
  232.  
  233.           PKEY  : <
  234.           PDATA : XPRESS#.BAT     : For Local
  235.  
  236.         The # refers to a designator to differentiate multiple batch
  237.         files for multiple HMS systems as you will see in a moment.
  238.         If you have more than one hudson base you should create more
  239.         than one Xpress data files (move them into sub directories below
  240.         Xpress as you create each one) and store them as follows
  241.  
  242.         Xpress ----------+
  243.                          |
  244.                          |
  245.                          +--- TYPE1
  246.                          |    +----- *.DAT
  247.                          |    +----- *.PRM
  248.                          |    +----- *.CTL
  249.                          |    +----- XPUSER.*
  250.                          +--- TYPE2
  251.                          |    +----- *.DAT
  252.                          |    +----- XPMAIL.PRM
  253.                          |    +----- *.CTL
  254.                          |    +----- XPUSER.*
  255.  
  256.        You will have to copy the files into the directories and rerun
  257.        TAG2XPR and XPADM -U for each different hudson directory. This is
  258.        of course because *only* TAG allows for multiple HMS bases at this
  259.        time.. Typically there will only be two separate bases one for
  260.        echo and one for local mail.. You will have to setup TWO
  261.        different Xpress menu options one for echo and one for local
  262.        messages.. any more than two bases is ridiculous unless you have
  263.        more than 400 message bases running. (personally I recommend only
  264.        one HMS base to maintain compatibility for the proliferation of
  265.        QBBS/RA utilities).
  266.  
  267.  
  268.  
  269. =======================[ Single Base Setup ]=====================================================
  270.  
  271.       For Single base setup:
  272.  
  273.       XPRESS.BAT
  274.       @Echo Off
  275.       TAG2EI %1 %2 %3 %4 %5 %6 %7 C:\XPRESS C:\BBS
  276.       CD\XPRESS
  277.       XPMAIL -A%2
  278.       CD\BBS
  279.  
  280.       That is it. The C:\XPRESS refers to the path to SilverXpress
  281.       Files and the C:\BBS refers to the path to your STATUS.DAT file.
  282.  
  283. =======================[ Multiple Base Setup ]=====================================================
  284.  
  285.  
  286.       For Dual base setup:
  287.  
  288.       XPRESSE.BAT
  289.       @Echo Off
  290.       TAG2EI %1 %2 %3 %4 %5 %6 %7 C:\XPRESS C:\BBS
  291.       CD\XPRESS
  292.       Copy TYPE1\*.*
  293.       XPMAIL -A%2
  294.       COPY *.DAT TYPE1
  295.       COPY *.CTL TYPE1
  296.       COPY XPUSER.* TYPE1
  297.       CD\BBS
  298.  
  299.       XPRESSL.BAT
  300.       @Echo Off
  301.       TAG2EI %1 %2 %3 %4 %5 %6 %7 C:\XPRESS C:\BBS
  302.       CD\XPRESS
  303.       Copy TYPE2\*.*
  304.       XPMAIL -A%2
  305.       COPY *.DAT TYPE2
  306.       COPY *.CTL TYPE2
  307.       COPY XPUSER.* TYPE2
  308.       CD\BBS
  309.  
  310.  
  311.       That is it. The C:\XPRESS refers to the path to SilverXpress
  312.       Files and the C:\BBS refers to the path to your STATUS.DAT file.
  313.       The data files you copy allow you to keep the users seperate and
  314.       not have to call Xpress with the "*" option for the local bases..
  315.       this is highly recommended.
  316.  
  317. ===================================================================================================
  318.  
  319.  
  320. That about does it.. Again I would HIGHLY recommend setting your system
  321. up with single HMS bases unless the 200 message area of the format is a
  322. problem.. you will simplify your life and make your self available for a
  323. wide range of offline editors,and utilities.
  324.  
  325. Oh.. incase you wondered about the lack of netmail discussion.. it's
  326. because TAG doesn't presently support a HMS style Netmail base.. Oh well
  327. great things take time.. like a fine wine TAG only gets better.
  328.  
  329.  
  330. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  331.                         )-=[ Bug List/Fix List ]=-(
  332.  
  333.  
  334. -09/10/92
  335.  
  336.         Known problem with user aliasing.. Xpress doesn't appear to be
  337.         reading the ALIAS.BBS File for some reason. Hector hasn't gotten
  338.         back to me as to why.
  339.  
  340.         Known bug with passing user time through the EXITINFO.BBS file..
  341.         Hector is looking into the problem at this time
  342.  
  343.         Rick's stupid
  344.  
  345.         Original DOCS confused the %2 time left parameter with the %3
  346.         user number parameter.. It read "-A%3" rather than the correct
  347.         "-A%2"... Ack!
  348.  
  349.  
  350.  
  351.